home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / scope / 076-100 / scopedisk83 / nib / nib.doc < prev    next >
Text File  |  1995-03-19  |  15KB  |  431 lines
  1.  
  2.             STELLAR SYSTEMS, INCORPORATED
  3.  
  4.                   presents
  5.  
  6.                   NIB V1.0
  7.  
  8.             © Copyright 1989 Shawn Liptak
  9.                 All Rights Reserved
  10.  
  11.  
  12.  
  13.  
  14.     This initial release of NIB (V1.0) may be freely distributed as
  15. long as:
  16.  
  17.     A. No charge is made for the program.
  18.     B. No more than $5.00 U.S. is charged for the disk.
  19.     C. No file is deleted or edited in any way.
  20.  
  21.     NIB is intended for archival purposes and to ease the burden of
  22. such copy protection schemes as "Master Disk", "Key Word", and "Code Wheel".
  23. Software authors have the right and a necessity to make a profit on their
  24. products. So, if you use it, then BUY it!
  25.  
  26.  
  27. +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  28.  
  29.                 SPECIAL OFFER
  30.  
  31.     NIB (V2.0) will be released as a commercial product in May or June
  32. of 1989. It will retail for $38.00 U.S. and feature new parameters, a disk
  33. editor, and an error checker. If you become a "Registered Owner" you will
  34. be entitled to
  35.  
  36.     A. NIB V2.0, which will be shipped to you free of charge
  37.     B. The first upgrade to V2.0 will cost $6.00 versus $9.00
  38.  
  39. To become a "Registered Owner" make out a check or money order to
  40. Shawn Liptak for $16.00 U.S.. Print or type the information in 
  41. the file Form.txt and...
  42.  
  43. Send to:
  44.             STELLAR SYSTEMS, Inc.
  45.             Attn. Shawn Liptak
  46.             P.O. BOX 9047
  47.             Hampton, VA 23670-0047
  48.  
  49. Note:
  50.     A. All registrations must be postmarked by May 15, 1989.
  51.     B. Virginia residents add 4.5% (72 cents) state sales tax.
  52.     C. To become a "Registered Owner" you must provide a valid
  53.         shipping address in the continental United States.
  54.  
  55.  
  56. +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  57.  
  58.     STELLAR SYSTEMS, Inc. is dedicated to providing quality
  59. software for the AMIGA series of computers. If you have software
  60. that is under development or finished and you are looking for a
  61. method of marketing it, please contact us at the address below.
  62. We can also provide code for specific applications such as custom
  63. disk access or title screens.
  64.  
  65.             STELLAR SYSTEMS, Inc.
  66.             Attn. Software Development
  67.             P.O. BOX 9047
  68.             Hampton, VA 23670-0047
  69.  
  70.     If you have any questions, comments, or complaints about
  71. STELLAR SYSTEMS or NIB, please write us at...
  72.  
  73.             STELLAR SYSTEMS, Inc.
  74.             Attn. PR
  75.             P.O. BOX 9047
  76.             Hampton, VA 23670-0047
  77.  
  78.  
  79. Amiga and AmigaDOS are trademarks of Commodore-Amiga, Inc.
  80.  
  81. +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  82.  
  83.                 NIB
  84.  
  85.  
  86.     Nib was written to be an economical disk backup system. It uses a
  87. precision disk nibbler combined with flexible parameters and a unique track
  88. selection system. This allows it to make working copies of a variety of
  89. protected software. The parameter system allows the copier to deprotect
  90. many titles and also to backup some especially tough ones. Nib's speed
  91. should be as fast as, if not faster, than the competition's and it should
  92. operate on all Amigas with a variety hardware configurations. Nib requires
  93. V1.2 or later of the Amiga's operating system.
  94.  
  95.  
  96. Limitations:
  97.  
  98.     Due to time constraints in development, Nib V1.0 does not support
  99. single drive copying and it does not check to see if the destination disk
  100. is write enabled. This will be added in V2.0.
  101.     When copying some copy protected programs Nib may indicate an error
  102. on certain tracks. You can use the ERR gadget to copy these bad tracks.
  103. If an error is still indicated then you should test the copy to see if
  104. it is ok.
  105.  
  106.  
  107. Multitasking:
  108.  
  109.     Nib will multitask with most programs without problems
  110. although there are a few things to keep in mind.
  111.  
  112.  1. If your source and destination drives are the same then
  113. Nib will attempt to read as much of the source disk as it can fit
  114. into available memory. So, it is best to have as much memory free as
  115. possible since a whole disk in nibble mode will require 2 Megs.
  116. * Note: This does not apply for V1.0, see Limitations:.
  117.  
  118.  2. When Nib is running it takes control of all floppy drives
  119. which makes it kinda difficult for the system or other programs
  120. to access the drives.
  121.  
  122.  3. When Nib is copying disks it tends to be a processor hog and
  123. will turn off multitasking for long periods of time. This will
  124. cause other programs to run slowly or not at all.
  125.  
  126.  4. When copying in either nibble mode, Nib will turn off the copper
  127. while it is reading or writing disk data. This causes the display
  128. to jump about and get very garbled looking (you'll see).
  129.  
  130.  
  131.     In light of the above I would suggest that you make a boot disk
  132. named SS.Nib that contains only Nib and it's associated files. Then to use
  133. Nib you would boot off of the SS.Nib disk which will start nib running with
  134. full memory use. The script file named "Execute.Me" will assist you in this
  135. operation.
  136.     You can also put Nib on a floppy or hard disk in a directory named
  137. for instance "NibMegaGreatCopier". This directory would contain the file
  138. "NIB" and a subdirectory named "NibData". The subdirectory would contain
  139. all of the other Nib files.
  140.  
  141. Then to start Nib from a floppy in DF1: type
  142.     Assign SS.Nib: DF1:NibMegaGreatCopier
  143.     SS.Nib:NIB
  144. or to start Nib from a hard disk partition named HD2: type
  145.     Assign SS.Nib: HD2:NibMegaGreatCopier
  146.     SS.Nib:NIB
  147.  
  148.  
  149.     Your questions and comments are welcome. If there are features
  150. or parameters you would like to see added to Nib or problems copying
  151. a disk please use the address given in the special offer section or
  152. leave me email on GEnie or "The Board".
  153.  
  154. GEnie S.Liptak1
  155. The Board  (804) 865-8773  300/1200  F8N1  On an Amiga 1000, 65 Meg online.
  156.  
  157.                         Enjoy,
  158.                         Shawn Liptak
  159.  
  160.                         March 1989
  161.  
  162.  
  163.  
  164.  
  165.                 Main Controls
  166.  
  167.     These are used to select the source and destination disks,
  168. verification, parameter and to start the copier. These gadgets are located
  169. in the left section of the screen and run from the top to the bottom of the
  170. screen. To use, select the appropriate gadget by positioning the mouse
  171. pointer over the gadget and depressing the left mouse button.
  172.  
  173.     Here are the steps to copy a disk:
  174.  
  175.     1. Select source drive.
  176.     2. Select destination drive(s).
  177.     3. Turn verify on or off.
  178.     4. Select a parameter.
  179.     5. Click "START COPY".
  180.     6. Insert appropriate disks.
  181.     7. Click on "OK!".
  182.     8. Sit back and watch it go (wheee).
  183.  
  184.     The rest of this section will deal with the various gadgets
  185. and what all this junk means.
  186.  
  187.  
  188. SOURCE:
  189.         Selects the disk drive that contains the disk you wish
  190.     to copy. Only one source disk may be selected.
  191.  
  192. DESTINATION:
  193.         Selects the disk drive(s) that contain the disk(s) you
  194.     will be copying to. You may select from 1 to 4 destination disks
  195.     provided that you have the drive connected to the Amiga.
  196.     Nib will not allow you to select a drive that you do not have.
  197.  
  198. VERIFICATION:
  199.         This toggles verification on or off. If turned on it
  200.     will cause the copier to read the information written to the
  201.     destination. This results in a slower copy, but it helps Nib
  202.     catch copy errors. I would suggest that you leave this on unless
  203.     you have a need to copy disks rapidly.
  204.  
  205. PARAMETER:
  206.         This brings up the parameter select requester.
  207.  
  208.         *****************************************
  209.         *        Select A Parameter        *
  210.         *                    *
  211.         *    Parameter1            *
  212.         *    Parameter2    UP        *
  213.         *    Parameter3       TOP/BOT    *
  214.         *    Parameter4    DN        *
  215.         *    Parameter5            *
  216.         *                    *
  217.         *    Finished             Forget It!    *
  218.         *****************************************
  219.  
  220.     UP: Scrolls the list of parameters towards the top of the list.
  221.     DN: Scrolls the list of parameters towards the bottom of the list.
  222.     TOP/BOT: Moves you to the top or bottom of the list. If you are
  223.         near the top you will go to the bottom. If you are near
  224.         the bottom you will go to the top.
  225.     Finished: Accepts the center parameter (Number 3) as the new
  226.         parameter and updates the current settings of the
  227.         track control.
  228.     Forget It!: Exits the menu with making any parameter changes.
  229.  
  230.         The top five parameters are used to select Nib's standard
  231.      copy modes. They are...
  232.     
  233.   NORMAL DOS COPY:        AmigaDos mode. Use for unprotected disks.
  234.   NORMAL NIBBLE COPY:        Nibble mode.
  235.   NORMAL NIBBLE+INDEX COPY:    Nibble with index. (Best)
  236.   QUICK NIBBLE COPY:        Nibble except source track is read only once.
  237.   QUICK NIBBLE+INDEX COPY:    Same as "QUICK NIBBLE COPY" with index.
  238.  
  239.         "NORMAL NIBBLE+INDEX COPY" is the best mode for copying
  240.     nonstandard format tracks. The "QUICK" modes are faster but will
  241.     only produce accurate copies if the originals are indexed or
  242.     have only one sync mark per track.
  243.  
  244. START COPY:
  245.         This brings up the start copy requester.
  246.  
  247.         *****************************************
  248.         *                    *
  249.         *    Insert SOURCE disk in drive     *
  250.         *    DF0:    DF1:    DF2:    DF3:    *
  251.         *                    *
  252.         *    Insert DESTINATION disk in drive    *
  253.         *    DF0:    DF1:    DF2:    DF3:    *
  254.         *                    *
  255.         *   OK!                CANCEL!    *
  256.         *****************************************
  257.  
  258.     DF0: thru DF3:    These will be indicated based upon the "SOURCE"
  259.             and "DESTINATION" selections.
  260.     OK!:         Starts the copy process.
  261.     CANCEL!:     Aborts the copy command.
  262.  
  263.         Before selecting "OK!" you should ensure that the write
  264.     protected source disk is in the correct drive and that the
  265.     write enabled destination disk(s) are in the indicated drives.
  266.     Nib does not check to see if the destination disks are write
  267.     enabled. It will still attempt the copy, which will result in
  268.     no data getting to the destination; if verify is on then you
  269.     will get LOTS of verify errors (0F/1F/2F).
  270.  
  271.         Once the copy starts you will get a window that looks
  272.     something like this...
  273.  
  274.     *************************************************
  275.     *    Track: 00                *
  276.     *    Destination: Max Words            *
  277.     *      FFFF    FFFF    FFFF    FFFF        *
  278.     *    Source: Index Time Delay        *
  279.     *      FFFF                    *
  280.     *    Source:    Track Total Time        *
  281.     *      FFFF                    *
  282.     *    Source:    Words Per Track            *
  283.     *      FFFF                    *
  284.     *    ERROR LOG: Track / Error #        *
  285.     *      00 0F  01 0F  05 2F  06 2F        *
  286.     *      1C 11  1E 22                *
  287.     *                        *
  288.     *                        *
  289.     *                        *
  290.     *    Press LEFT mouse button to abort    *
  291.     *************************************************
  292.  
  293.     Track: 00
  294.         Is the hex value of the current track (00 to A5).
  295.  
  296.         The next four items are used in the nibble modes and will
  297.     probably be useful only to the more advanced user.
  298.  
  299.     Destination: Max Words
  300.       DF0:  DF1:  DF2:  DF3:
  301.         The capacity of a track on the appropriate destination
  302.         drive. Typically 186A (Hex).
  303.  
  304.     Source: Index Time Delay
  305.       FFFF
  306.         The timer count from the index hole to the first sync
  307.         mark. Should be from 0 to less than track total time.
  308.         If many tracks have similar index times then it may have
  309.         an index type copy protection.
  310.  
  311.     Source:    Track Total Time
  312.       FFFF
  313.         The time count for the disk to do one revolution.
  314.         Should be 6FDC for 300 RPM and an NTSC clock. Each count
  315.         equals 6.984 usecs. 8,590,908/count(decimal)=RPM.
  316.  
  317.     Source:    Words Per Track
  318.       FFFF
  319.         The number of words of data on the current track.
  320.         186A is a normal value. If the value is substantially
  321.         larger (greater than 19E0) then it may have long track
  322.         type copy protection.
  323.  
  324.     ERROR LOG: Track / Error #
  325.         This section contains a log of the first 16 errors.
  326.         The first digit is the track number and the second
  327.         is the error code. The table below contains the error
  328.         codes and their meanings. Many errors can be cleared
  329.         by using the ERR gadget to copy the bad tracks again.
  330.  
  331.     x1=Could not locate a sync mark. If in any nibble mode, the read
  332.         routines will enter sync search mode. This can take up to
  333.         12 seconds and the screen will flash yellow during this
  334.         time.
  335.     x2=Can't find gap or too many sectors. Should not happen.
  336.     x3=No sync after gap. Will occur if source only has single sync
  337.         marks and mode is AmigaDOS.
  338.     04=Can't find sector (decode). You may have a bad source disk.
  339.     05=Can't find sector (encode). Same as above.
  340.     x8=Write error. Rare indeed.
  341.     xF=Verify failed. This is probably the most common error. If verify
  342.         is on then Nib will read the destination and compare with
  343.         the source. If different it will copy the track again and
  344.         do a second comparison. If the second comparison fails
  345.         then you will get this error. This may mean the destination
  346.         track is bad or is write protected. Verify will also
  347.         fail if the source track contains illegal MFM values or
  348.         has fluctuating bit type copy protection.
  349.     41=No sync on destination speed test. Should only occur if the
  350.         destination has a bad track or it's write protected.
  351.     
  352.     x equals the copy mode 0=AmigaDOS, 1=Nibble, 2=Index Nibble
  353.  
  354.  
  355.  
  356.  
  357.  
  358.                 Track Control
  359.  
  360.  
  361.     This unit determines which tracks will be copied and in what 
  362. mode it will occur. It also contains gadgets to access other functions
  363. when they are implemented (Error Checker, Disk Editor).
  364.  
  365.     The main unit is the track select and status indicator which
  366. appears like this...
  367.  
  368.             BOT        TOP                   +------+
  369.         --- -- ----- -0 - ----- -- ---               | MODE |
  370.         --- -- -----      ----- -- ---            +--+------+--+
  371.         --- -- -----      ----- -- ---        G.> |  AmigaDOS  |
  372.         --- -- -----      ----- -- ---            +------------+
  373.         --- -- -----      ----- -- ---        H.> |   Nibble   |
  374.         --- -- ----- -5 - ----- -- ---            +------------+
  375.         --- -- -----      ----- -- ---        I.> |Index Nibble|
  376.     +> [+]    --- -- -----      ----- -- ---  [+]        +------------+
  377.     |    --- -- -----      ----- -- ---                   +
  378.     |  [-]    --- -- -----      ----- -- ---  [-]           +-------+
  379.     |   |    --- -- ----- -10- ----- -- ---        J.>    |SET ALL|
  380.     |   |     |       |          |       |   [ERR]           +-------+
  381.     |   |     |       |          |       |     |
  382.     |   |     |       |          |       |     |
  383.     |   |    --- -- ----- -80- ----- -- ---    |
  384.     |   |    --- -- -----  |   ----- -- ---    |
  385.     |   |    --- -- -----  |   ----- -- ---    F.
  386.     |   |    |  |    |    |
  387.     |   |    |  |    |    The cylinder number
  388.     A.  B.   C. D.   E.
  389.  
  390.  
  391.     A. Plus: The plus gadget on the left selects all bottom tracks
  392.         The plus gadget on the right selects all top tracks.
  393.  
  394.     B. Minus: The minus gadget on the left deselects all bottom tracks
  395.         The minus gadget on the right deselects all top tracks.
  396.  
  397.     C. Track Status: Green indicates that the track was copied
  398.         successfully. Red means that there was a problem with
  399.         the track and you should see an error code in the error
  400.         log.
  401.  
  402.     D. Track Selection: This determines if the track is selected.
  403.         To change the state of selection you can either use the
  404.         plus, minus, or ERR gadgets, or you can use the mouse
  405.         pointer to toggle the indicator on or off.
  406.         Yellow = Selected for copy.
  407.         Black  = Not selected.
  408.  
  409.     E. Track Mode: The current copy mode of the track. This can be set
  410.         by selecting the appropriate mode (Items G, H, I.) and
  411.         clicking the mouse pointer on the track you wish to change.
  412.         White = AmigaDOS.
  413.         Green = Nibble.
  414.         Blue  = Index Nibble.
  415.  
  416.     F. Error Select: This gadget will deselect all good tracks (green).
  417.         This is handy when you make a copy and a few tracks show
  418.         error conditions (red). You can then select this gadget
  419.         and then "START COPY". This will cause only the bad tracks
  420.         to be recopied.
  421.  
  422.     G. AmigaDOS select:
  423.     H. Nibble select:
  424.     I. Index Nibble select:
  425.         Items G, H, and I set the current copy mode selection of
  426.     the mouse pointer for item E.
  427.  
  428.     J. SET ALL: This takes the currently selected gadget G, H, or I
  429.         and sets all of the tracks (item E.) to that mode.
  430.  
  431.